健康分类值类型（HealthCategoryValue）# PRO

本文档列出了 HealthCategorySample.create() 及相关 API 中支持的所有 HealthCategoryValue 枚举类型。每个枚举值用于表示特定 HealthCategoryType 的分类结果。

#1. HealthCategoryValuePresence

适用类型：

• mindfulSession（正念训练）
• intermenstrualBleeding（经间出血）
• sexualActivity（性行为）
• pregnancy（怀孕）
• lactation（哺乳）

说明： 用于表示事件是否发生。

#2. HealthCategoryValueSeverity

适用类型：

• menstrualFlow（月经流量）
• acneSeverity（痤疮严重程度）
• hairLossSeverity（脱发严重程度）
• abdominalCramps（腹痛）
• headache（头痛）
• nausea（恶心）

说明： 表示症状的严重程度。

#3. HealthCategoryValueSleepAnalysis

适用类型：

• sleepAnalysis（睡眠分析）

说明： 描述某时间段内的睡眠状态。

#4. HealthCategoryValueOvulationTestResult

适用类型：

• ovulationTestResult（排卵测试）

#5. HealthCategoryValuePregnancyTestResult

适用类型：

• pregnancyTestResult（怀孕测试）

#6. HealthCategoryValueProgesteroneTestResult

适用类型：

• progesteroneTestResult（孕酮测试）

#7. HealthCategoryValueCervicalMucusQuality

适用类型：

• cervicalMucusQuality（宫颈黏液质量）

#8. HealthCategoryValueContraceptive

适用类型：

• contraceptive（避孕方式）

#9. HealthCategoryValueVaginalBleeding（仅 iOS 18 及以上支持）

适用类型：

• vaginalBleeding（阴道出血）

#10. HealthCategoryValueAppetiteChanges

适用类型：

• appetiteChanges（食欲变化）

#11. HealthCategoryValueAppleStandHour

适用类型：

• appleStandHour（Apple 久坐提醒）

#12. HealthCategoryValueAppleWalkingSteadinessEvent

适用类型：

• appleWalkingSteadinessEvent（步态稳定性事件）

#13. HealthCategoryValueEnvironmentalAudioExposureEvent

适用类型：

• environmentalAudioExposureEvent（环境音暴露事件）

#14. HealthCategoryValueHeadphoneAudioExposureEvent

适用类型：

• headphoneAudioExposureEvent（耳机音量暴露事件）

#15. HealthCategoryValueLowCardioFitnessEvent

适用类型：

• lowCardioFitnessEvent（心肺适能不足事件）

#使用示例

const sample = HealthCategorySample.create({
  type: "menstrualFlow",
  startDate: new Date("2025-07-03T10:00:00"),
  endDate: new Date("2025-07-03T12:00:00"),
  value: HealthCategoryValueSeverity.moderate
})

await Health.saveCategorySample(sample)

#注意事项

• value 的值必须与 type 对应的枚举类型一致，类型不符会导致错误。
• 请确保已获得 HealthKit 权限后再调用读取或保存方法。
• 所有枚举值最终会映射为 Apple HealthKit 的 HKCategoryValue 存储。